Short: Makes guide of aminet files etc. v1.7
Author: fini.alring@netmedia.dk (Fini 'Warp' Alring)
Uploader: fini.alring@netmedia.dk
Type: comm/misc
Requires: Arexx, rexxsupport.library, aminet:util/sys/DirII.lha (v3.3a).
Version: 1.7
Long:


                  Fini "Warp" Alring of GiGA Productions.


                                 Presents
 
 
                       ·GigaGuide (ex. AmiNetGuide)·






*************** This program requires this cool Dir replacement: ***************


             It can be found on Aminet:pub/util/sys/DirII.lha


********************************************************************************


******************************* NOTE about GIF support: ************************

  Even though I don't like this format, we have to trouble ourselves, for some time.
  Since GIF is used widely on the net.  I suggest you only use PNG & JPEG.
  
  
  
  See more info about the Portable Network Graphics format (PNG) at this URL:
  
         W3C - World Wide Web Consortium. >> http://www.W3C.org <<
 
********************************************************************************


 
 I made it because my dowload dir, is approx. 80MB, and I simply can't cope with it!
 
 Dopus just isn't enough... ;-)
 
 
 GigaGuide scans the first line of all readme files in a given dir,
 
 where the Short: description is located (Look at the first line of this text!!!)
 
 It then generates an AmigaGuide, with links to both readme and it's main file.
 
 It can also be used to make a guide of your pictures dir, or archives dir etc...
 
 When you click on the filename gadget, 
 the archive will be decompressed into Ram:, or anywhere you desire 
 (you can also choose by file requester).
 
 Pictures and Samples can be viewed/played by a siple click, 
 using you preferable viewer/player.
 
 When you click on the Short: text, the whole readme file will be shown.
 
 Sub-Dirs are shown as gadgets, and by a click, 
 you can generate a Guide for that directory too.
 
 It can put the Short:-line into the archive's filenote (comment),
 which is very useful, especially for BBS ownerS! ;-)
 
 It can sort files in 'Alphabetical order' or 'Newest at top order'.


History: (This will be moved to a Guide soon! =)

Names bounded with brakets ( [Fini Alring] ) is the names of persons 
who gave me the idea, of the certain feature... thanks guys!!! =)

----

 New in v1.7 - 25.Nov.1997
 
 Comment: At last another Aminet release. I'm planning a v2.0 w/GUI (And CLI!) etc...

 · IMPRO  C:Lha is copied to Ram:, when -X option, is enabled. Faster!
 
 · IMPRO  GG now also support readme files with the '.REA' suffix, for people who
          download stuff on a M$-PC! - [Thanks Guido! ;-]

----

 New in v1.7ß - 19.Oct.1997 - Only for beta testers.
 
 comment: Sorry for delay, but I wanted this version to include a lot of things. 
 
 · ADDED  Option -NL = Don't make linespaces in the guide. [Jannik Rasmussen!]
 
 · ADDED  Option -X  = Attempt to extract missing/corrupt readme's from archives (lha only)

 · ADDED  Option -GD = Set Guide Destination, for CD-ROM's etc.. (-GD Ram:)
          [Joel Dulon! - Sorry you had to wait sooo long!]

 · ADDED  Text file suffixes: .text .doc .dok

 · ADDED  .exe suffix supported, file is launched.
 
 


----
 
 New in v1.6 - 07-Jul-1997
 
 Comment: AminetGuide has changed name to GigaGuide. Enjoy this cool version!
 
 · FIXED  Download dir path, can have spaces in it. 
          In v1.4 only my argument handler supported it. 
          
 · IMPRO  Usage text, Delete gadget and other cosmetics. 

 · FIXED  The -Aminet.guide will not be shown it it's own list.
 
 · ADDED  AminetGuide now requires DirII v3.3a+ by Stephen Davies ©1995
 
 · ADDED  Option: -SM. CASE = Alpha order.  DATE = Newest files at the top.

 · ADDED  Filedates are written in the -Aminet.guide.

 · ADDED  Option: -N = Set the min. length of filename gadgets. ( -N 18 )
 
 · ADDED  Option: -U REQ = Brings up a dir-requester, so you can choose where to unpack!
          Note:   If you hit cancel, it will unpack to the dir, where the guide is.
 
 · ADDED  Option: -NS = No screen, guides will open on workbench screen. 
 
 · ADDED  Option: -SP = Sound Sample player. (-SP C:Play16) 

 · ADDED  ZIP support, using C:Unzip.
 
 · ADDED  PNG picture support. 
 
 · ADDED  IFF picture support. 
 
 · ADDED  HAM picture support. 
 
 · ADDED  HAM8 picture support. 
 
 · ADDED  ILBM picture support. 
 
 · ADDED  FILE_ID.DIZ support using multiview. 
 
 · ADDED  8SVX sound sample support.
 
 · ADDED  WAV sound sample support.

 · ADDED  SND sound sample support.
 
 · ADDED  Old -Aminet.guide's will be deleted automatically.
          (This will be done, in the next couple of versions).
 
 · MODIF  Because of the new name created guides, will be called -GiGA.guide instead.
 
 · IMPRO  Info content now shows all options, and supported suffixes, and more.

----

 New in v1.5 - 25-Jun-1997 

 Comment: Can now unpack/view files, which doesn't have a readme file.

 · IMPRO  AmiNetGuide can see all files, even if they don't have a readme file.
 
 · IMPRO  This history text, now uses MCP's history format.

 · FIXED  Guide "hanged" when opening a Sub-Dir guide.
 
 · FIXED  Sub-Dir guides did not use the options set by user.
 
 · FIXED  Multithreading now works 100% :). 

 · ADDED  AmigaGuide® support using MultiView (or other clone).
 
 · ADDED  NFO support (Text files) using MultiView (or other clone).
 
 · ADDED  DMS support, unpacks DMS files (defaults to RAD:).
 
 · ADDED  Option: -D = Set DMS unpack destination. ( -D RAD: )
 
 · ADDED  Ignores .info files (Icons). 
 
 · ADDED  Readme files also gets the short: message attached, in -C mode.

----

 New in v1.4f - Fixed a bug, no default value for short length... 
                ups! why does it always happen!!
----

 New in v1.4 (Huge update!!!) 13 Jun 1997.
 


 · Made a very good argument parsing, which also alows to use spaces in in args, 
   eg. "Dh1:Down load"  <- Just put double quote on both sides. 
 
 · Added Seven (Yup 7! ;) options, of which many have been requested by users. 
 
 Usage:
 
 	AminetGuide <Download dir> [Options]

 Options:

 -F = Sets Guide font.  ( -F Topaz.font 8 )

 -V = Path to MultiView. ( -V C:Multiview )

 -U = Set unpack dir. ( -U Dh1:Download/Unpacked/ )

 -S = Set the length of Short: notes. ( -S 55 )

 -C = Add Short: into filecomment, of the archieve.

 -G = Don't make Guide, use if only filecomments are wanted.

 -P = Path to image viewer. ( -P C:PPshow )

 · Option characters are non-case dependant ( -c = -C ).

 · Options can be put in any order, but all it's arguments must be entered.

----

 New in v1.3 - (Ups! Pic bug!) 09 Jun 1997
 
 · Pictures couldn't be viewed. - Sorry! Won't happen again! ;-D
 
 · Added LZH support. - Unpacks using LHA.
 
 · Added TXT support. - Using Multiview. - [Per Gustav Ousdal]
 
 · Short: message is now 55 chars long. - Legal Short:'s should only be 40 chars,
   but many people don't respect this. Tell me what length you want! Maybe argument?

----

 New in v1.2 (Bugfixed v1.1) 08 Jun 1997

 · Sorry guys!! I didn't test v1.1 good enough, it couldn't unpack lha... 
   This is fixed...  Once again, I'm very sorry!

 · Download paths can be bounded with double quotes eg. "dh1:download/"
   This is needed for Dopus v5.5 (and Magellan). (  C:AminetGuide {s}  )

 · GIF is now supported, some guy asked for it, and it was soo easy to support!
   Even though I don't like this format, we have to trouble ourselves, for some time...
   Since GIF is used widely on the net.  I suggest you only use PNG & JPEG.
 
-----

 New in v1.1 (Added lots of new things.)
 
 · Proper Alpha sorting. - [Per Gustav Ousdal]
 
 · LZX support - Now also unpack lzx archives.
 
 · Added gadget "Delete" - Deletes archive, and readme file.
 
 · Readme files are now opened on their own screen.
 
 · JPG and JPEG are now supported, requires PPshow.
 
 · Sub directories are detected, gadgets at the bottom!! - [Martin Lundqvist]
 
 
 Note: AminetGuide must be in C: to make Sub-dirs work..!
 

--------------------------------------------------------------------


 Usage: GigaGuide <Download dir> [Options]
 
 
 Other features:
 	
 	· It's MailWare - I only want your own productions, and a little letter...! 
 	
 	· It multithreads, so you can unpack many files at ones, 
	  and have multiple readme windows opened at the same time...
 
 	· The -GiGA.guide will be placed in the download directory...




Future: 

	· Type sorting.
	
	· Support of more pictures and Archives.
	
	· Maybe support for FILEID.DIZ extraction.
	
	· Which picture viewer should be default?? 
	
	· write me!! 8)



*** NOTE:  To get more help, start the program without arguments ***



Author: fini.alring@netmedia.dk (Fini 'Warp' Alring)

IRC:  Sunsite.auc.dk or irc.FUnet.fi (FUnet - EFnet?).  Channel: #AmigaDK


NOTE to bug reporters:  

 Please tell me what version you are using, since I make updates frequently.  


                 
                      Only Amiga makes it possible!!!
